home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / Internet / Misc / Traceroute 1.0.sit / Traceroute 1.0 / Traceroute 1.0 Release Notes / Traceroute 1.0 Release Notes
Encoding:
Text File  |  1995-02-04  |  9.3 KB  |  218 lines  |  [TEXT/R*ch]
  1. MacTraceroute 1.0                                                 02/04/95
  2. ©1994-5 Jim Browne (jbrowne@uiuc.edu)
  3.  
  4. (No awards yet, but since when do unfinished applications win awards?)
  5.  
  6. • Contents
  7.     What is it?
  8.     How much does it cost?
  9.     What's new with this release?
  10.     Any known bugs in 1.0?
  11.     What do you plan for future versions?
  12.     What are the features?
  13.     How do I use it?
  14.     How does it work?
  15.     Who should I sue if it destroys my machine?
  16.     Who should I thank?
  17.     Who wrote this?
  18.     What else has Jim Browne written?
  19.     What horrid bugs existed in former versions?
  20.     
  21. • What is it?
  22.  
  23. MacTraceroute is a program that attempts to trace the route an IP packet would
  24. follow to some internet host.  It is not guaranteed to be 100% accurate, but
  25. more often than not is close enough to reality to assist in debugging network
  26. problems.
  27.  
  28. • How much does it cost?
  29.  
  30. Nothing.  MacTraceroute and the associated Traceroute Ethernet LAP are free.  You
  31. can do anything you want with them except incorporate them into a commercial
  32. product without my written permission.  Public domain, shareware, and SUMEX-like
  33. CD collections, however, may include both packages on their product.
  34.  
  35. • What's new with this release?
  36.  
  37. 1)    Zoomed windows are constrained to available desktop.
  38. 2)    Now using System 7's new window stagger function since it's there.
  39. 3)    Probes per TTL used actually matches value in New Traceroute dialog,
  40.     rather than using one less than the value entered.
  41. 4)    When traces are started when MacTraceroute is in the background
  42.     (i.e. from an AppleEvent), windows have inactive scrollbars (as
  43.     they should).
  44. 5)    Trace times are now "attached" to the right side of the window.
  45. 6)    Results of traces may now be copied to the clipboard.
  46. 7)    Fixed the application icon masks.
  47.  
  48. • Any known bugs in 1.0?
  49.  
  50. 1)    Simultaneous traces act a little weird.  Excessive timeouts.
  51. 2)    Some visual problems with the trace window: Horizontal scroll bar
  52.     problems.  Sometimes updates aren't drawing everything.
  53.     
  54. • What do you plan for future versions?
  55.  
  56. 1)    Add some optional parameters to the "traceroute" appleevent.
  57. 2)    Make New Trace dialog moveable modal.
  58. 3)  Implement pinging of hops.
  59. 4)    Incorporate Adam Goodfellow's nifty path MTU discovery code.
  60.  
  61. • What are the features?
  62.  
  63. MacTraceroute implements almost all of the features supported by the UNIX
  64. traceroute command.  MacTraceroute does not currently support the Loose
  65. Source Record Route option of traceroute.
  66.  
  67. • How do I use it?
  68.  
  69. First, hit command-n to bring up a new traceroute dialog.  Type in the host
  70. name or IP address of the host you wish to attempt to traceroute to.  The
  71. remaining fields in the dialog require some explanation:
  72.  
  73.     Max TTL:    This specifies the maximum ttl traceroute should use in
  74.                 its outgoing probes.  This usually coincides with the
  75.                 number of hops, but not neccessarily.
  76.                 
  77.     Timeout per Probe: This specifies the number of seconds to wait for a
  78.                 response to a probe.
  79.                 
  80.     Probes per TTL: This specifies the number of probes to send with a given
  81.                 TTL value.  Usually is Probers per hop, but not always.
  82.                 
  83.     Starting Port: This specifies the UDP port number that MacTraceroute will
  84.                 start the probes at.  If something on the target machine is
  85.                 using a port at or just above this port number, traceroute may
  86.                 fail to work correctly.  If you suspect this to be the problem,
  87.                 try a different starting port.  This field is automatically
  88.                 filled with a random number.
  89.                 
  90.     Resolve IP Addresses: If this is checked, MacTraceroute will try a reverse
  91.                 DNS lookup on the ip addresses of each hop.
  92.                 
  93.     Loose Source Record Route: Currently not supported.
  94.     
  95.     The remaining fields can be used to set certain bits in the probes' IP
  96.     header.  Reference RFC 791 for a complete description of these fields.
  97.     They are, in my opinion, self explanatory.
  98.  
  99. After you hit the "Traceroute" button, a window will appear showing the results
  100. of the traceroute.  The number on the left is the hop number.  To the right of
  101. this is the IP address of the hop, and optionally the DNS name of the hop.
  102. To the right of this information is the round trip time for each probe.
  103.  
  104. When the trace is completed, the window title will have a "•" inserted at the
  105. beginning.
  106.  
  107. A few other things can appear in place of round trip times:
  108.     !SE     An error occurred when attempting to send the probe
  109.     *       A timeout occurred waiting for the probe to return
  110.     !N      A network unreachable condition was reported
  111.     !H      A host unreachable condition was reported
  112.     !P      A protocol unreachable condition was reported
  113.     !S      A source route failure occurred
  114.     !F      A fragmentation needed condition was reported (Shouldn't happen)
  115.     
  116. • How does it work?
  117.  
  118. MacTraceroute works by sending UDP packets with a destination IP address of the
  119. host you wish to trace to, and an artificially low TTL field.  When a gateway or
  120. router forwards an IP packet, it decrements the TTL field.  When the TTL field
  121. is decremented to zero, an ICMP Time Exceeded error message is sent to the
  122. originating host.  Thus, by sending out UDP packets with TTLs of 1,2,3, and so
  123. on, and listening for the ICMP error messages, you can determine the route the
  124. packets are taking to the host in question.  This method is not 100% reliable,
  125. for reasons beyond the scope of this document.   It works well enough for most
  126. uses.  MacTraceroute requires a special LAP for MacTCP since MacTCP does not
  127. allow applications to modify the TTL field of packets, nor does it give
  128. applications direct access to ICMP messages.
  129.  
  130. • Who should I sue if it destroys my machine?
  131.  
  132. Not me.  The MacTraceroute application and the Traceroute Ethernet LAP have no warranty
  133. whatsoever.  I have tried to eliminate all of the bugs from the code, but I probably
  134. will never eliminate them all.  If MacTraceroute or the LAP damage your machine in any
  135. way, I am sorry, but I cannot be held liable.  If you think it stinks just remember:
  136. You get what you pay for.
  137.  
  138. • Who should we thank?
  139.  
  140. First and foremost, the legendary Van Jacobsen (van@helios.ee.lbl.gov).  This
  141. application was inspired by and is directly derived from the code of Van Jacobsen's
  142. traceroute.
  143.  
  144. VJ thanks Steve Deering, C. Phillip Wood, Tim Seaver, and Ken Adelman in the
  145. traceroute man page, so you should too.
  146.  
  147. I would like to thank Blaine Kubesh for bugging me to work on the MacTraceroute
  148. application and the Traceroute Ethernet LAP.  I'd also like to thank Apple for
  149. producing A/UX, a UNIX implementation so crappy it drove me to port traceroute 
  150. to MacOS.  Without A/UX, I'd probably be happy to continue running traceroute
  151. on my local UNIX box.
  152.  
  153. As with everything I program, Matt Elliott for being such a nagging pain.  I
  154. probably would just watch TV all day if it weren't for Matt bitching at me. ;)
  155.  
  156. I should also thank Steve Dorner for exclaiming 'Why in the hell are you doing
  157. that there?' (paraphrased) about my LDEF code.  He put me onto the trail of some
  158. updating bugs that have plauged many of my programs.
  159.  
  160. • Who wrote this?
  161.  
  162. MacTraceroute was written by Jim Browne (jbrowne@uiuc.edu).  Jim was a Senior in
  163. Computer Engineering at the University of Illinois - Chambana.  Jim currently works
  164. for Sonic Systems, Inc., a manufacturer of Ethernet hardware and Macintosh
  165. Software.  Jim likes all things related to Led Zeppelin and frisbee (which is a brand
  166. name and registered trademark of the wham-o mfg. company).  Jim doesn't mind getting
  167. bug reports and wish list suggestions via email, so long as they contain "Traceroute"
  168. in their subject so Eudora can filter them to the proper mailbox.  Beginning with the
  169. writing of this file, Jim apparently likes referring to himself in the third person.
  170.  
  171. • What else has Jim Browne written?
  172.  
  173. DNSLib    A library that makes working with MacTCP's DNR much easier by providing
  174.         application-time callbacks for DNR responses, queueing of DNR requests,
  175.         and handling of N concurrent DNR questions.  MacTraceroute and MacFSP use
  176.         this library.
  177.         
  178. MacFSP    A Macintosh client for the FSP protocol.
  179.         
  180. • What horrid bugs existed in former versions?
  181.  
  182. Version 1.0b1 (12/23/94):
  183.  
  184. 1)    DNS errors from the destination host lookup produce an error dialog.
  185. 2)    About Dialog is now centered.
  186. 3)    Horizontal window growth is now bounded.
  187. 4)    Removed "Probes Per TTL" from info bar as it was redundant.
  188. 5)    Zoom box has been added.
  189. 6)    Support for the four required appleevents added.
  190. 7)    Support for a "traceroute" appleevent.
  191.  
  192. Version 1.0d4 (11/22/94):
  193.  
  194. 1)    Fixed the corruption bug that was causing intermittent crashes.
  195. 2)    Fixed the "crash if you close an active traceroute window" bug.
  196. 3)    Fixed the updating bugs.
  197. 4)    Text is no longer clipped at the bottom (losing the bottom of a "g", etc.)
  198. 5)    First hop is no longer duplicated.
  199. 6)    Target hop results are now displayed.
  200. 7)    Scroll bar strangeness has been corrected.
  201.  
  202. Version 1.0d3 (11/4/94):
  203.  
  204. 1)    New interface.
  205. 2)    Optional inverse DNS lookups of hops.
  206. 3)  Fixed "crash on second trace" bug.
  207. 4)  More than one traceroute allowed at a time.
  208. 5)  Precedence and Type of Service implemented
  209.  
  210. Version 1.0d2 (7/30/94):
  211.  
  212. This release fixes a bug in the source IP address in the outgoing traceroute
  213. probes.
  214.  
  215. Version 1.0d1 (7/29/94):
  216.  
  217. This is the first time this code has left my machine in any capacity.
  218.